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If you need more information about the UNZIP program 
which is used by our BOOT program to unpack the files, we 
suggest that you visit Dilwyn Jones’ web site where you find 
more information about lots of interesting QDOS software 
and INFOZIP at hitp:/www.dilwyn.uk6 net/arch/index.html 


Something very strange happened in the middle of January, We cannot remember if or when it has 
ever happened before, but it heralds good news for QL Today readers. 


About three weeks before the copy date for this issue we had almost enough material fo fill the ma- 
gazine. To our surprise articles continued to come in until just after the deadline. 


This has been a successful volume of QL Today. We have had a small rise in readership. The DVD that 
came with issue 1 was much appreciated and we received compliments for the content of issue 2. 
Issue 3 has 42 pages instead of the promised 32, and we have a small arnount of material over for 
issue 4, 


As we near the end of each volume we have to think about the future of QL Today and decide whe- 
ther or not to continue. In 2010 and 2011 this decision was not easy. This year we have no doubts. 
There have been many positive developments. There will be a volume 17. 


One welcome development has been the wider variety of topics. At one time there was little cove- 
rage of hardware, but it now has a firm place in the magazine. In this issue Adrian ves graphically 
describes the frustrations of developing new products. 


When Steve Poole could no longer write for us, we were worried about the coverage of SuperBasic. 
Last issue we looked at the SCALE command and in this issue Tobias Fréschle writes about RND and 
RANDOMISE. | have plans to cover another keyword in a future issue, but | wonder if you also have 

one you would like to write about. 


One weakness in both QL Today and the Quanta Magazine has been games coverage. Peter Scott 
has written reviews for both magazines, but, given the amount of effort that RWAP Software has put 
into preserving and re-releasing games software, | would welcome more games content. 


Recently the British education minister has been critical of computer education in schools, describing 
it as being boring lessons on using Word and Excel. He wants pupils to learn programming through 
writing games. 


At about the same time | was surprised, and somewhat flattered, to discover four articles from the 
help page of my website on an e-book download site. One was my guide to user friendly program- 
ming which is heavily based on articles | wrote 13 

years ago. Although it was written for the QL 


much of the content would be relevant to pro- . 

grammers for other systems. Perhaps even Corrections 

for today’s school students learning program- | A number of errors crept into the last issue of QL 
ming. Today. 

Maybe we retro enthusiasts are not quite the References to the 2009 Quanta AGM in the last 


dinosaurs some think us to be, but could be- minute news on page 44 should have been to 
come foday's trend setters. Certainly the arti- the 2010 Quanta AGM. 


oe Leary this year indicate QL- Norman Dunbar has also pointed out two errors 
ers have much still to offer. in his Pari 29 assembler article. 


In my final editorial for volume 15 | expressed ‘Page 29: There seems to be a spare 10" at 
a concern about a fall in the number of con- the very end of the last line. The value for the 
triuters and pleaded for more writers. Thanks | number of IW Objects should be 0 and not 0.0. 


to all of you who have responded. It is down , : 

to you that there will be a volume 17. Just Page 31: The final sentence in the paragraph 

keep those articles coming in! above the heading "3. The Generated Code 
should end after AppMenufest!Win_asm. The 
chunk "The file should look similar.” appears to 
be a duplicate of the first sentence of the fol- 
lowing section’ 


Microdrive Slot Card 
Reader Nearer Reality 


An SD card reader for the microdrive slot on 

native hardware has come a step closer after 

Peter Graf handed over the final stages of the 

project to Memory Lane Computing. 

Early last year Peter Graf raised the possibility of 

an SD/MMC card reader for the QL and sugges- 

ted several different possibilities, including the 
use of the QL ROM port, the parallel port on the 

Super Gold Card, the CPU socket or the 

microdrive slot. Most users expressed a prefe- 

rence for the last of these. 

Late last year Peter released details of the final 

design: 

‘The QL-SD hardware system has two parts: 

1) A board which plugs into an internal QL 
ROM socket It has a Minerva style EPROM 
socket on top. EPROMs with QL operating 
oe plus QL-SD driver could be used 

ere, 

2) A board which is mounted behind a micro- 
drive slot inside the original QL case. After 
the microdrive has been removed (which is 
quite simple) the new SDHC-card drive can 
be mounted with two screws. SDHC cards 
can be inserted just like microdrives :-) The 
drive LED for the SDHC card is separate 
from the original microdrive LED, so no 
internal wiring must be changed. It is visible 
beside the card socket. 

ed parts are connected by a simple ribbon 

cable. 


Peter reports that the project has taken up much 
ime that is no longer available and believes the 
best chance of making progress would be to 
transfer the task to Memory Lane Computing 
who have a good track record in producing 
innovative hardware and drivers. He has passed 
on all his schematics, parts lists, files for PCB 
manufacture and source code together with a 
small number of PCB prototypes. Peter adds that 
Memory Lane computing is entitled to release 
he product or modify it. 

Head of Memory Lane Computing, Adrian Ives 
says of Peter's work: 

"| would like to pay tribute to Peter's design and 
engineering skills in creating the QL-SD and 
getting the original C driver up and running. The 


product has always been his brainchild but we 
are very happy to be able to take it forward 
and will hopefully do that design justice. 


He also summarised the present state of deve- 
lopment: 
‘The hardware is working on black box QLs but 
there are still some issues to be overcome relat- 
ing to noise pickup. This is especially problema- 
lic if the SD card holder is mounted in a vaca- 
ted microdrive slot. Peter has already re- 
designed the PCB to get around this problem, 

There are problems with the Super Gold Card 

that have not yet been resolved. The Gold Card 

has not been tested at all (because | don’t have 
one). 

The software is written. There are two drivers 

available: 

1) QL-SD, a driver written in C derived from 
Dirk Steinkopf's QL-HD driver At present 
this is too big to fit into a 16K EPROM and 
needs further optimisation. 

2) An EDDE 2 driver that is both compatible 
with the Ser-USB and USBWiz over Q-BUS 
and is able to mount FAT32 volumes holding 
file system images. This is ROM-able and 
supports booting from an SD Card. All v2.x 
Ser-USB/Q-BUS utilities (Partition Manager 
etc} work with this and the partition formats 
are identical, ; 

3) An EDDE 2 Block Device Interface driver 
for Q-emuLator's emulated hardware inter- 
face. This allows file system images to be 
accessed on the PC and read/written by QL 
software running under Q-emuLator 

1 currently have two functioning hardware proto- 

types: 


QL SD - a view inside the open case 


QL SD from outside 


The QLROMEXT which plugs into one of the 
QL's internal ROM sockets, The SD Card carrier 
fits into a vacated microdrive position. 

The QLROMEXTernal which plugs into the ROM 
port with the SD Card socket onboard.’ 


The images of the device accompanying this 
report are taken from the QL modifications page 
of Lee Privett's website: 
https://sites.google.com/site/theqlimagerepository/ 
products 
In other Mernory Lane Computing news Adrian 
Ives has now discontinued the USB_SER product 
because the USBwiz module that it uses has 
reached ihe end of its life and is becoming 
difficult to obtain. It will also free his time to 
concentrate on other products. Support for 
existing users will be maintained. 

Adrian hopes to altend the Manchester Quanta 
workshop at the end of March. 


Crucial Votes at 
QUANTA AGM 


Quanta members are to vole on the jaox 
controversial six year rule and the terms faaae 
of office of committee members at the fe 
AGM before voting on a new constitution. F 
The draft constitution that was sent to fe 
members last summer retains the present § 

arrangements, but feedback was invited 
from the members on whether they 
wanted changes. : 
Only one member provided feedback and 
the Quanta Committee feels the issues 
are of such importance that votes are 
necessary to clearly establish the desire 
of ihe members before final voting on the 
constitution. 


The six year rule requires committee members 
to sland down for a least a year after completing 
six continuous year of office. The idea is to pre- 
vent the committee from becoming stale by en- 
couraging fresh blood. Members will vote on 
whether or not to extend the rule from 6 years 
service to 9 years service. 

Currently the present terms of office are 3 years 
for officers and 1 year for ordinary committee 
members. The proposal is for both officers and 
ordinary committee members to serve for 2 
years. 

Under the Quanta Constitution voting on con- 
stitutional matters requires a two-thirds majority 
for any changes to be made. 


QI-FORUM Interview 


The October/November issue of the Quanta 
Magazine contained an interview with the foun- 
ders of the QL-Forum which celebrated its first 
anniversary at the end of November 2011. 

The forum was set up by Peter Scott with Rob 
Heaton providing the technical help. Peter 
comments: 

"We never thought about research, deciding 
just to build it and hope people will turn up. | 
knew it would be slow and steady progress 
initially just expecting a few posts a week with 
the odd person signing up but it's done far 
better than | expected.’ 

The initial target was 100 members in the first 
year and 99 were achieved. There are about 
2,000 page views a month and about 50% of the 
visitors are guests, some of whom will also be 
members who only sign on when they wish to 
comment. The forum has become international 
with posts from, among other countries, Italy, 
France, Germany, Holland and Sweden. 

Mid February there were 1l7 members and 2101 
posts on 323 topics. 


Software Updates 


George Gwilt has updated two programs: 


SETW 


SETW, which produces window definitions for 
TurboPT, C and EasyPEasy has been updated to 
version 7.08. This alows the use of the largest 
possible names and directories. The names are 
used for the files produced by SETW. The direc- 
tories can be set either by Config or by a para- 
meter list. Directories can be set for such things 
as the output files. Thus if a directory is set for 
the assembler file the output will be put both in 
rami. and in the set directory. 


GWASS 

1. This allows the use of JSRL adrs to mean 
JSRL {adrs). The same applies to JMP 
These work whether adrs is an explicit 
absolute address or a label. 

2. Byte sized immediate «eas on assembly 
should now all produce a word with the first 
byte zero. Previously such an instruction as 

MOVE.B #+2,D0 
would have had $FFFE as the word. This will 
now assemble to $00FE. 
http://gwiltprogs.info/ 


QEMULATOR 


Daniele Terdina has announced a Q-emuLator 
blog, at 

http://qemulator.blogspot.com/ 

He anticipates it will be a low traffic blog, mainly 
to inform existing users of new updates. 
Updates for both Windows and OS X have just 
been released. 


Q-emuLator 4.1 for. OS X 


Feemeg 


OSeaas 


UK Postcodes 


Just Words! has updated its postcodes program, 
jointly written with Dilwyn Jones, to use the new 
QL friendly map databases being developed. The 
program is available on the downloads page of 
he Just Words! website and now includes the 
source code. For any user wishing to experiment 
with the UK map, the mapping routines are in 
lines 10010 to 10210 and the database from 
10230 to 12650. 

www.gwicks.net/justwords.htm 

The program can also be downloaded from 
Dilwyn's website: 
www.dilwyn.me.uk/misc/index.html 


News from Dilwyn Jones 
PCB DESIGN V7.23 


Malcolm Lear has released another update to 
his PCB Design program, which is available to 
download free at 
hitp://www.dilwyn.me.uk/graphics/index.html 
Malcolm says that there are ‘a lot of changes 
this time, mostly removal of the dot matrix, 
HPGL and the obsolete Gerber-D drivers. This 
means a cleaner export program that's much 
easier to maintain. Gerber-X export has been 
updated by using the correct area fill 
commands rather than a plot fill which creates 
massive files. Component label size can now be 
adjusted by 5 mil steps rather than 20. 


eBooks Website 

Several QL eBooks are now available to 
download from my website at 
http://www.dilwyn.me.uk/docs/ebooks/index.html 
This includes commonly used reference guides 
such as the QL User Guide, C68 manual 
and Toolkit 2 and Turbo manuals. | have 
prepared an article for QL Today on the 
subject of eBooks and why | have 
pursued this topic. The eBooks are 
available in ePub, Mobi and PDF formats, 
making them suitable for many eBook 
readers and tablet PCs. | am very 
grateful to people like Adrian Ives for 
the assistance given and in particular 
for converting many of the eBooks 
available so far. 


QL Online Manual 

Following on from the eBooks project, 
there is now an online copy of the QL 
* manual, split into the four sections of 


Introduction, Beginner's Guide, Keywords and 
Concepts sections. Some sections have an 
index, whereby you can-click on a link in a list of 
keywords and be taken to the entry for that 
command or function in ihe Keywords Guide, for 
example. Hopefully now that this manual is 
available online, it wil be easy to access 
anywhere where you have an_ internet 
comection, and will also be useful for new or 
returning QL users who may not have access to 
a paper manual. 

The online QL manual is available at 
hitp://www.dilwyn.me.uk/docs/ebooks/olgiug/index.htm 


”“THE SHELL” Update 
Adrian Ives has released an updated version of 
the command shell for QDOS called The Shell 
Version 112 fixes a problern with matching nested 
pairs of brackets that incorrectly parsed expres- 
sions like $(%isfile:$(fllename)). 
Other changes include: 

*set’ is now a synonym of ‘let’. 

If an autoexec_bat startup command file is not 
found, the Shell will look for a file called 
autoshell_bat. 

A special comment of the form "requires nnn in 
a batch file will stop execution of the file if the 
Shell version number is less than that specified. 
The Shell is available to download free from 
http://www.dilwyn.me.uk/shells/index.htmi 

Adrian has also revised some of the extensions 
in his package called extens.zip on the Toolkits 
page of my website - download it from 
htto://www.dilwyn.mé.uk/tk/index.him! 


Q-STRIPPER Update 


Norman Dunbar has released a recompiled 
version of his Q-Stripperprogram for Windows, 
which lets you view and convert Quill DOC files 
to other formats. 

This version will now work as a 32-bit application 
on a Windows 7 64 bit system. 

Remember that this is a Windows program, not a 
QL program! 

Download Q-Stripper from 
http://www.dilwyn.me.uk/filetran/index.html 

lf you need the compiler support files, these are 
a separate 5 megabyte download from the same 
page, 


GST QL Software 

Thanks to Urs K6nig and encouragement from 
Rich Mellor, | have now added the GST QL soft- 
ware bundle to my website for all to download 
free on a non-profit basis. A while back, Jeff 


Fenton of GST gave permission for these pro- 
grams to be downloaded on this basis. 


68K/0S 

| have created a new page on my website for 
the GST 68K/OS stuff at 
http://www.dilwyn.me.uk/gst68kos/index.html 
although it doesn't include the microdrive soft- 
ware part as | don't know how to convert it (it's 
not the same as QDOS microdrive formal). 

On this page you can run a 68K/OS system in a 
QemuLator demo which Urs had prepared. 

If, ike me, you get error messages when you try 
to use the demo QemuLator after unzipping eve- 
rything, it is probably because you have another 
version of QemuLator already on your system - if 
So, use your registered version, go into the ‘QL’ 
menu, select ‘QL Configuration’ and find the 
GST_68K-OS BIN file to use as Main ROM in 
Qemulator and deselect any Back ROM such as 
a Toolkit 2 ROM image. Click OK. QemuLator 
should now start as a 68K/OS. 


GST Q-MAC and QL Assembler 

The Q-Mac and GST QL Assembler are both on 
the Assembler page on my website. The QL 
Assembler is under GST-ASM, and the Q-Mac is 
under Q-Mac on the page: 
http://www.dilwyn.me.uk/asm/index.html 


GST QC Development System 

The GST QC development system is a C 
compiler system for the QL, originally supplied on 
microdrive cartridges, on™ my C page at 
http://www.dilwyn.me.uk/c/index.html 

under GST QC. 


Various manuals, pictures and scanned adverts 
and reviews are also available as separate zip 
and PDF files on the pages. Some of them are 
quite large, eg. the scanned QC manual is over 
20MB, so take note of the file sizes before 
downloading (file sizes are in brackets alongside 
the descriptions). 


J-M-S Email 

My email address SMSQ@j-m-s.comhas been hea- 
vily sparmmed for some months now (300... 1000 
mails per day). This is the only account which 
gets so many junk mails, so | had to increase the 
spam filtering to ‘much stronger’... impossible to 
look at so many junk mails manually. In case you 
write to me and get no reply, please use the 
freshly created SMSQ@j-m-s.de ... or better use 
this new email address in general in the future. 


As | have already written, 64-bit arithmetic can be achieved by using C. 
This was useful since the task of actually writing routines in assembler to do the arithmetical actions 


could be shelved. However, 64 bits is really quite small compared with many integers. | thus 
determined to find a way of dealing with larger numbers. 


As it happened, one member of the Scottish QL Users Group (SQLUG} told me about an assembler 
program he had written to divide one large number by another This was exciting. | would not need 
focus my thoughts on what | considered a difficult area. Another ray of light came when a second 
member of SQLUG suggested that it should be possible to apply the same method to multiplication as 
to division. i told him that this was nonsense. Later, of course, | realised that it was in fact eminently 
sensible. 


In the programs explained below it is assumed that all numbers are positive. 
First here is a general description of the methods used. 


Addition and Subtraction 
The Motorola 68000 chip has a very useful instruction which allows extended addition. This is: 


ADDX.L  —(Ax) ,-(Ay) 


Its purpose is to allow the extended number to the end of which Ax points to be added to the second 
extended number to the end of which Ay points. The instruction itself subtracts 4 from both Ax and Ay, 
adds together the long words to which the registers now point, adds the current value of the extend 
bit (X), sets a new value of the extend bit according to the result and stores the answer in Ay. As you 
can see, repeated application of this instruction will add together two extended integers. | call the 
routine to do this ‘addnm’, 


Subtraction can be done in exactly the same fashion using SUBX in a routine called *subnm’. 


Division 

The method used to divide one number by another i is really in essence very simple. You continually 
subtract a number fromthe dividend, each time reducing the dividend, until it becomes less than the 
divisor. Of course | did not just use the divisor as the number to be subtracted. What | did was to 
multiply the divisor by that power of 2 which made it just less than the dividend. This, of course, can 
greatly reduce the number of subtractions needed to get the answer. 


However, there is the question of how to achieve multiplication by a power of 2. In essence this is 
simple enough. All you need to do is to shift up the bits of the multiplicand. It is easy enough to do this 
inside a register. for example: 
LSL.L #4,D0 
will shift up the contents of DO.L four bits thus multiplying it by 2°4. 

In an extended number this won't quite work. The shift can be expressed as a number of long words 


(N) with the residual number of bits (B). If B is zero the shift is just N long words. Otherwise we need to 
determine new values for the long words in the answer. 


To find the new value of a long word | put it in DO and use the instruction: 
ROL.L  #4,D0 


This shifts up the bits of DO.L as before, but any bits which go over the top reappear at the bottom of 
DO. These bits at the bottom of DO will be those which need to be placed at the bottom of the next 
long word. We are counting backwards here, just as for ADDX. So, what we do is to roll round the bits 
in along word, capture, separately, the bits at the bottom which have gone over the top and the bits at 
the top which have been shifted up. To these latter bits are added those bits which came over the top 
of the previous word. An iteration will give the shifted answer we need. 


The routine performing this action is ‘shft’. 


One problem remains here, though. That is, how do we find how far to shift the divisor? We need to 
shift the divisor up so that its most significant bit is in line with that of the dividend, or perhaps is just 
one bit lower As a first trial we align the numbers. To find the shift amount we need to know the 
position of the most significant bit in both integers. This, naturally, 
requires yet another routine. This one | call *gbit’, short for ‘get bit’. By using this we get the positions 
of the top bit in both integers. By subtraction we find the amount of the shift. 
As mentioned above, the shift can be expressed as N long words and B bits. In fact the position of 
the most significant bit in an integer is set by “gbit” as N in the upper word and B in the lower word of 
Di. If the positions in the two integers are NIIBI and N2IB2_ then the amount Ni-N2IBi-B2, will give the 
correct amount to shift if both NI-N2 and Bi-B2 are positive. If B2 » Bi, then we will need to adjust the 
amount of the shift by adding 32 to the low word and subtracting 1 from the upper word. 


Multiplication 

At first sight multiplication is nothing like division. In division we keep subtracting from a known number 
until we get the answer in multiplication of M by N we could get the answer by adding M to the answer 
N times. In the same way as for division, we make a short cut by shifting up the multiplicand the right 
number of bits for each bit in the multiplier and adding the shifted result, This is beginning to look like 
my method of division but with ADDX instead of SUBX. 

To do this we need to know the positions of all the non-zero bits in the multiplier To know when to 
stop the loop doing the shifting and adding we need to know also how many non-zero bits there are 
in the multiplier 


“gbit’ comes to the rescue here, for it turns out thal the same code can give us all these answers. 


Program 
It looks as though we can do the arithmetic on large integers using the six routines: 


addnm Add A to B 

subnm Subtract A from B 

divs Divide A by B 

muls Multiply A by B 

gbit Find number or position of bits 
shft Multiply number by power of 2 


We actually need four more routines. These are required for housekeeping and testing. The additional 
routines are: 


elrnm Clears A 


comp Compares A with B 
putbit Sets a bit in the quotient during division 
tstnm Tests a number for positive, negative or zero 


Before listing the routines it should be explained that each integer is stored in a certain number of long 
words, The number of these is contained in the word ‘sze’. As an example this is taken here as 20. 
There are also two working spaces for numbers. These are called spi and sp2. 


sze de.w 20 Number of long words holding integers 


3 addnm adds two numbers 
3 On entry : AO and Al point to the end of the numbers 
3 On exit : DO=-1 if overflow, 0 otherwise 


addnm: 
move .W sze, dd size of numbers . . 
subq.w #1,d0 . . less 1 (clears the extend bit) 
addi addx.1 -(a0),-(ai) 
dof dO, addt 
add3 bvs add2 overflow (here D0,W = -1) 
add4 moveq #0, 40 good answer 


add2 ext.1 fels) sets DO.L 0 or -1 


3 subnm subtracts one number from another 
3} On entry : AO and Al point to the end of the numbers 


: On exit : DO = -1 if overflow, 0 otherwise 
subnm: 
move.W sze,d0 
subq.W #1,d0 
sub subx.1 ~(a0),—(al) 
dbf a0, subi 
bra add3 
divs divides 21 by 22 and sets the quotient to 23 
AO —> a1 
Al —~ 22 


The quotient goes to 23 

and the remainder to al 

A2—-> 23 

If 22 is 0, DO.L is set to —18 


div_reg reg d5-7 

divs movem.1 div_reg,~(sp) 
movem.1 a0-i,-(sp) keep pointers 
movea.1  a2,a0 
bsr elrnm clear answer space 
movea.l ai,ad 
bsr tstnm is 22 zero? . 
beq divs5 _-) + » yes —> OVR 
movea.1 (sp),a0 
bsr tstnm is 21 zero? .. 
beq divs_end1 » . yes ~» answer zero 
movea.l  sp2,a0 
ber elrnm clear temporary answer 
move.W sze,d0 


movea.l ail,a0 
moveq #-1,d1 
bsr gbit 


get 1st bit position of 22 (p2) 


move. 1 di,d7 pe 
3 The procedure loops here 
divs4 movea:1""(sp) ; a0 AQver ad 

move.W sze,d0 

moveq #-1,d1 get 1st bit position of 21 (p1) 

bsr gbit 

move. 1 di, dé pl 

emp.1 a6, a7 

beq divs_same pl = p2 

bpl divs_endi p2 >» pi - finished 
divs7 

move.1 a6, a0 

sub.1 a7, d0 amount of shift 

tst.w do 

bpl divsi 

subi.l #$f£fe0, dO adjust to positive mod 
divest move. 1 do, d5 amount of shift to D5.L 
divs6 move.w sze,dt 

subq.W #1,41 

movea.l  sp2,a0 

ber elrnm AO set to end of sp2 

movea,l a0Q,al Al -» end of sp2 

movea.1 4(sp),a0 22 

move.W sze, dd 

isl.w #2,a0 

lea (a0, 40.w),a0 to end of 22 

move, 1 d5,a0 amount to shift 

bsr shft shifted value of 22 to sp2 
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movea.1  (sp),a0 
movea.L sp2,al 
bsr comp 
beq divs2 
bhi divs3 


3 do subtraction here and set answer 


movea.l1 sp2_e,a0 
movea.l  (sp),at 
move.W sze,d0 
lsl.w #2,40 
lea (a1, d0.w),al 
bsr subnm 
move.1 a5,d0 
bsr putbit 
bra divs4 
3 The shift was one bit too much so try 
divs3 tst.1 ad 
beq divse_end1 
subq.1 #1,a5 
tst.w dd 
bpl divs6é 
subi.1 #$ffe0,d5 
bra divs6 


3 dividend is now zero 


a1 
compare 21 and sp2 


put answer and finish 
now shift one less and try again 


AO ~» end of sp2 
Al - 21 


Al - end of 21 

zi - sp2 

bit position 

set this position in the answer 
do next bit 

1 less 

finished 

shift less 1 


adjust shift? . . 
+ » no 


clear remainder 
set last bit in answer 


reset stack for AO/1 


compare 21 with 22... 
+ not equal - continue loop 


dividend is now zero 


clear answer space 


divs2 movea.l (sp),a0 
bsr elrnm 
move.1 d5,a0 
bsr putbit 
divs_end1 moveq #0,d0 OK end 
divsend lea 8(sp), sp 
movem.1 (sp)+,div_reg 
rts 
divs5 moveq #-+18,d0 OVR signalled 
pra divs-end 
3 The bit positions are the same (no shifting needed) 
divs.same movem.1 (sp),a0-i 
bsr comp 
bne divs7 
moveq #0,d5 bit position 0 
bra divs2 
3 muls multiplies A by B and puts the answer to C 
3 On entry AO — start of A 
3 Al - start of B 
3 A2 -» start of 0 
3 On exit DO is 0 if OK. CC are set 
mul_reg reg d6-7 
muls movem.1 mul_reg,—(sp) 
movem.1 aQ-1,-(sp) keep pointers 
Movea,l a2,a0 
bsr elrnm 
movea.l a0,a2 


3 Test numbers for zero 


(sp) »a0 
tstnm 


movea.1 
bsr 


point to end of answer 


test A 


j Test if 
3 Set the 
muls2 
muis3 


beq 
movea.1 
bsr 
beq 
movea.1 


muis4 
4(sp),a0 
tstnm 
mils4 
(sp), a0 


shift would give OVR 


move.W 
moveq 
bsr 
move.1 
movea.1 
moveg 
move.W 
bsr 
add.1 
subq.wW 
lsr.w 
move.1. 
swap 
add.w 
cmp.W 
bget.s 


sze,d0 
#-1, 01 
gbit 
di, a7 
4(sp),a0 
#-1,d1 
sze, dd 
gbit 
a7, a1 
#1,41 
#5, 41 
di, a7 
di 
a7,dt 
sze, dal 
mulst 


——) 


find ist bit of A 
ist bit position to D7.L 
AQ — B 


find 1st bit of B 

add positions of A and B 
one bit less 

longwords (+1, 0 or —1) 


estimate of no of long words 
too big? . . 
. yes 


number with least bits as multiplier 


movea.1 
move.W 
moveq 
bsr 
move.W 
movea,1 
move.W 
moveq 
bsr 
move.w 
emp.W 
ble 
movem.1 
exg 
movem.1 
move.W 


neg.w 
movea.1 
bsr 
move.W 
move.wW 
movea.1 
bsr 
movea,1 
move.W 
1sl.w 
lea 
movea.1 
move.1 
bsr 
tst.w 
bne 
movea.1 
movea.1 
bsr 

bne 
addq.w 
bne 


(sp),a0 
sze, dd 
#0,d1 
gbit 
d1,d7 
4(sp),a0 
sze,d0 
#0,d1 
goit 
d1,d6 
a6, a7 
muls2 
(sp) ,a0-1 
a0,al 
a0-1, (sp) 
d6,a7 


a7 

sp2,a0d 
elrnm 

a7, 41 

sze, dd 
(sp),a0 
gbit 
4(sp),a0 
sze, dd 
#2,d0 
(a0,40.w),a0 
spi,al 
di,do 
shft 
40 
muist 
sp2_e, a0 
az,al 
addnm 
mulsi 
#1,47 
muls3 


enone > 


A 


get no of bits inA.. 
» . to D7 
B 


get no of bits of B. . 

+ » to D6 

a7 « d6 

switch A and B 

AO to least bits 

number of bits in multiplier 


clear sp2 


Di = position of rth bit 
B to AO 


-» end of number B 


shift to spi 


OVE 


Answer address end 
add shifted multiplicand 
OVR 
ended? . . 
. not yet 


movea.l sp2,a0 
bsr elrnm 
moveq #0,d0 

muis4 lea 8(sp),sp 
movem.1  (sp)+,mul_reg 
rts 

muls1 moveq #-18,d0 
bra muls4 


gbit counts the bits in a number or re 


On entry: 

DO.W = number of long words in number 
DL.W = 0 for count and ~r for positio 
AO — the start of the number 


no 


On exit: 
D1.W = number of bits or D1.TOP = bit 


; 
3 
3 
3 
3 
3 
3 
3 
3 
7 
3 
3 


; No other registers are used 


clear sp2 
mark OK 
tidy stack 


OVR 


turns position 


m of rth non zero bit 


DIV 32 : D1.W = bit MOD 32 


If D1,W is negative there is no bit for the position requested. 


gbit_reg reg d2-3 

ebit movem.1 gbit_reg,—(sp) 

gbits tst.w a0 
beq gbitt no more words 
subq. W #1, 40 eount down 

gbit2 tst.1 (a0)+ look for non-zero lwd 
dbne dO, gbit2 
beq gbitl finished 
move.1 -4(a0) ,d3 ist non zero word 
moveq #31,d2 bit count less 1 

gbit3 isl.1 #1,43 search for non zero bit 
dbes d2, gbit3 branch till bit found 
addq.w #1,a1 one bit found and. . 
beq gbit4 . . its place found 
subq.W #1,d2 adjust bit count since the. . 

; » « DBCS did not alter D2.W 
tst.1 d3 any bits left here? .. 
beq gbits » » no: go to next long word 
bra gbit3 finish this lwd 

gbiti movem.1 (sp)+,gbit_reg 
rts 

3 This sets the position of the rth non-zero bit 

gbit4 move.W d0,d4 pit DIV 32 
swap di 
move.W d2,a1 bit MOD 32 
bra gbiti 

Shift up 
On entry DO.TOP = shift number div 32 - W 

DO.W = shift number mod 32 -— B 


AO -> end of number 

AL -» end of answer space 
On exit DO,W = 0 if no overflow 
No other registers are used 


Nee ee ee ee ee ee ee 


S - W long words of AO are shifted to 
starting from the end at long word W. 


Mee ee ee we 


Inside D3 = long word operand 


long words of Ai 
(S igs size of numbers). 


D4 = Ist storage of bottom bit 


3 = 

3 D5 = 2nd storage of bottom bit 
; D6 = bottom mask 

3 D7 = top mask 


3 Note that an error occurs if: 

3 1. The shifting sets non-zero bits too high up (D5 non zero). 
3 2. There are non zero words at the top not to be shifted. 

3; 3. The answer is negative. 


sh_reg reg d2-7 

shft move .W sze,d1 
subq.w #1,a1 
tst.1 dO ifpdo=0.., 
beq copyt + » just copy 


movem.1 sh_reg,~(sp) 
move, 1 d0,d2 


swap d2 W (n div 32) 

sub.W d2,di adjust count 

Isl.w #2, 42 prepare. . 

suba.w d2,at . » answer address 
isr.w #2,02 restore long word count 
moveq #1, 06 prepare masks 


1si,1 dO, a6 
subq.1 #1,06 
move.1 a6, a7 


not.1 a7 
moveq #0, 85 set previous bottom bit to 0 
shfti move.1 (a0), 43 get long word 
rol. d0, a3 shirt it 
move.l 43, d4 keep. . 
and.1 a6, a4 . . bits shifted out 
and.1 a7, d3 clear the shifted bits 
or.1 d5,a3 insert previous shifted bits 
move.1 d3,—-(a1) insert altered long word 
move. 1 a4,d5 prepare for next long word 
dbf d1,shft1 count all long words of number 
bne shft2 D5 not zero (error) 
bra shft3 
shft4 tet.1 -(a0) look at remaining words in AO 
shft3 dbne d2,shft4 
beq snft2 no error (and D5 = 0) 
moveq #1,05 signal error 
shft2 move.W d5,a0 signal any overflow 
bne shft5 error already found ‘ 
tst.1 a3 is this negative? . . 
bpl shits >» « no OK 
moveq #1,40 set error 
shft5 movem.1 (sp)+,sh_reg 
rts 


3 ¢clrnm clears the number AO points to the start of 


elrnm move.W sze,d0 
subq.W #1,00 

elri elr.1 (a0)+ 
dbf d0,cirt 
rts 


3 comp tests two numbers for equality 
3 On entry AO -» ist and Ai ~ 2nd 
3 DO, AO and Al used. 

3 On exit condition code Z is set for equality else not 


comp move.W sze,d0 
subq.W #1, a0 

compi empm. 1 (a0)+, (at)+ 
dbne d0,compi 
rts 


3} copy copies AO to Al 
3 AO — end of ist number 
3 Al — end of 2nd number 


copy move .W sze,dt 
subq.w #1, a1 
copyi move.1 ~(a0) ,-(at) 
dbf di, copy1 
moveq #0, 40 signal no overflow 
rts 


; putbit sets the bit in a number 

3 A2 points to the start of the number 

; DO containg the bit position p [ p div 32 | p mod 32 } 
; Uses Di and AO : DO unaltered 


putbit move.W sze,d1 
lsl.w #2,d1 


lea (a2,d1.w),a0 AO -» end of number 
move.1 dO, di 
swap at 
isl.w #2,41 Number of lwds 
suba.W d1,a0 Point to end of lwd to be altered 
move.1 —(a0), a1 
bset d0, dt Mark bit 
move.1 a1, (a0) Set altered lwd 
rts 

3 tstnm test a number for neg, zero or positive 

3 con codes set mi, eq or gt 

3 if number is $80000 . . . mi set and DO = -1 

3 If number is <0 and not $80000 . . D0 

tstnm move .W sze,d0 size... 
subq.¥ #2, a0 » . less’ 2 
tet.1 (a0)+ ist long word 
bmi tst3 negative 
bne tstt non zero 


3 now test for zero 


tst2 tst.1 (a0)+ 
dbne d0, tst2 
addq.w #1,d0 DO is zero if number is 
tstL rts 
tst3 move.1 -4(a0) ,d0 ist long word again 
1s1.1 #1, a0 shift up 1 
bne tet4 set d0.0 and neg CC 


move.W sze,d0 
subq.w #2,d0 


tst5 tet.1 (a0) + 
dbne dO, tst5 
bne tst4 OK - not $80000000 
ext.1 ad sets ce neg and a0 -1 
rts 

tst4 moveq #1,4d0 Signal $80000000 
move #8,cer 


rts 


Recently, there was a discussion in the QL Forum about QL 
S*BASIC RND and RANDOMISE. | thought this topic would be a nice one for a QL publication. 


Creating random numbers is for a computer ~ built as a machine that handles exactly reproducible 
calculations - one of the hardest tasks to do, So anything a computer does regarding random num- 
bers is, in a mathematical sense, considered pseudo-random. Computer scientists are content when a 
sequence of random numbers looks random. The following are some requirements to be met by a 
computer's random number generator (RNG): 


Equal distribution of random numbers across the target range (the probability of getting a specific 
value should be the same for all the values in the target range) 
The sequence of numbers delivered by the RND function should not be easily detectable. 


It should be guaranteed that no specific value is excluded from the sequence of generated numbers 
(this aligns with (1) but is a bit different) - This means, that when run for a very long time, the se- 
quence of generated random numbers should contain all possible values, 


How is this achieved in SuperBASIC? 
| have not checked in the real system, but in theory, the generation of pseudo-random numbers works 
as follows {and | would expect the QL’s RNG doesn't work much differently): 


a 4 


When a new random number is needed, the register is shifted to the left and the bit shifted out XORed 
with specified: bit-positions-in-the registerand- shifted: in-from: the right:The resulting value is then 
scaled into the range needed (RND (x TO y)} or interpreted as a floating point value between 0 and 1 
(in the case of RND with no argument). This procedure generates a sequence of random numbers. The 
“quality” of a random number generator is measured by the requirements given above ~ the method 
shown in the picture (where the bil positions 16, 14, 13, and 11) are used by the feedback loop has 
proven especially good in that respect. 

Another term used in pseudo random number generation is the so-called seed, which is nothing else 
but the initial value of the register being shifted around. This naturally affects the sequence of numbers 
being provided. 

The QL system variable SV.RAND holds the system random number register, while the Basic Variable 
BV_RAND holds the same for the super basic job(s). 


RANDOMISE 

Simple - This just sets the initial value in the shift register From there on, the RND function provides 
numbers starting from there. If you give an argument to RANDOMISE, you are guaranteed to get the 
same sequence of numbers in every run of your program. 

lf you don't give an argument, the S*BASIC RNG (BV_RAND) is initialized from the system RNG 
(SV_RAND}. This makes it ‘truly” random (as SV_RAND seems to be initialized based on the system 
clock somehow ~ {t is also used for the Microdrive random IDs), 


RANDOMISE is probably the most misunderstood BASIC function (regardless on what computer). Most 
people seem to think this should be used to make RND more random. The opposite is the case. 
RANDOMISE is used to make the sequence of random numbers generated from RND reproducible. 


Without using RANDOMISE, RND should be just about as random as possible {at least when you are 
not starting your program from a BOOT file which could result in the same timing between the start of 
the computer and the execution of your program) 


The easiest way to make RND as random as possible is: 


100 REMark Random 
110 PRINT "Press any key to continue" ; PAUSE -1 : RANDOMISE 


This introduces the user waiting until a key is pressed as some sort of random seed. 


Fancy Uses of the RNG 


Apart from the more obvious uses for the RNG - likerolling dices or creating other random numbers, 
you can use random numbers (with the proper seed) as a source for reproducible sequences of 
numbers or as a source of statistical input. The sample programs have been created on QPC, but 
should equally run on any QL with at least TK2 fitted. 


PI and Rainfall 

This seems to be a method for calculating PI that 
has been invented in the British Islands (Wales, 
probably) or in some similar rainy landscape. 


Ingredients: 


1. An exact square of 2 x 2 meter (or foot, or 
whatever your favourite measure might be) of 
ground area 

2. a-circle of radius one centred within that square 

3. rainfall 

4, {lots of) patience 


Let there be rain (random) on our square. Count the 
raindrops that fall into the square. Additionally, count 
the amount of raindrops that also fall into the circle. 
Calculate PI from the proportion of the two figures. 
In our program, lines 120 to 200 iterate over single 
raindrops. The ‘landing’ position in our area js 
randomly generated in line 130, line 140 checks 
whether the raindrop landed in the circle or not. 


The Circle area calculates as 

e = PI r2 

The square is 

s=4r°2 

Eliminating r°2 and inserting the equations into each other, PI evaluates to 

4e/s8 

This is the formula used in line 190 to calculate our current approximation of PI. 

The check whether the raindrop falls into the circle uses good old Pythagoras to check whether the 
radius from the origin falls within the circle. 


The program also shows the rain falling on our experiment graphically. | have used OVER -1 to be able 
to see rain falling even when the complete figure is already filed with ‘raindrops’, 


100 REMark CalePI 

110 Initialise 

120 REPeat loop 

130 x“ = RND: y = RND 

140 IF isInCirele (x, y) THEN 
150 in=in+1 

180 END IF 
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182 out = out +1 

185 POINT #inner, x, y 

190 AT #outer, 11,10: PRINT fouter, 4¥in/outs" 
200 END REPeat loop 

210: 

220 DEFine PROCedure Initialise 

230 outer = FOPEN ("con_") 

240 inner = FOPEN ("con_") 

250 WINDOW #outer, 138, 140, 18, 18 
260 PAPER #outer,0 

270 INK #outer,2 

280 BORDER #outer,2,1 

290 CLS #outer 

300 WINDOW #inner, 135,100,20, 20 
310 SCALE #inner, 2,-1,-1 

320 INK #inner, 0 

330 PAPER #inner, 4 

340 CLS #inner 

350 FILL #inner, 1: CIRCLE #inner, 0, 0, 1: FILL #inner,0 
360 INK #inner, 2 

365 OVER #inner,—1 


370 «ine 1 

380 «out =a1 

390 AT #outer, 10, 0: PRINT#outer, "PT: "; PI 
400 AT #outer,i1, 0: PRINT#outer, "Cale: Ns 

410 END DEFine 

420: 


430 DEFine FuNetion isInCirele (x, y) - 
440 IF SQRT(x * x + y * y) < 1 THEN 
450 RETurn 1 


460 ELSE 
470 RETurn 0 
480 END IF 


490 END DEFine 


This is probably not the fastest method to calculate Pl (On my QPC laptop it took more than an hour to 
converge to something reasonably resembling Pi), but it's an interesting method anyway, as it both 
tests the quality of the RNG and the floating point precision of your computer. 


How to hide your secrets using RND 

Another interesting use of the Random Number Generator is ciphering of text. As the RNG generates 
reproducible sequences of random numbers when seeded with the proper values, it can be used to 
decode and encode secret messages. Funny thing is: Without a QL, nobody (well, except the NSA, 
probably) can decode your messages. I'm not even sure whether the RNG has changed through the 
lifetime of the various QL incarnations, ie whether you would be able to decode a file ON QPC that 
has been created on a real QL. 


The program uses the constant string in line 10005 as the string to cipher It is encoded using the 
method described below and written to a file on ramdisk. The second part of the program (starting 
with line 10040) reads that encoded file, asks for the decoding key and translates it back to something 
readable, provided that you still remember the key (an arbitrary floating point number). 


10000 out = FOP_NEW("rami_testfile") 
10005 a$ = "Hello World - This is secret" 
10010 z2$ = encode$(a$) 

10020 PRINT #out;2$ 

10030 CLOSE #out 

10040 in = FOPEN ("rami_testfile") 

10050 INPUT #in, b$ 

10060 PRINT "Secret String:";b$ 


10070 e$ = encode$ (b$) 

10080 PRINT "Decoded: ";c$ 

10085 CLOSE #in 

10090 : 

10100 DEFine FuNction encode$(x$) 
10105 LOCal i,a, b, o 

10107 =y$ =" 

10110 INPUT "Key: "ja 

10120 RANDOMISE a 

10130 FOR i = 1 TO LEN (x$) 


10135 a = CODE(x$(i)) 
40137 b = RND (32 T0 128) 
10138 =a7b 


¢ 
10140 y$=y$&CHR$(c) 
10150 END FOR i 
10155 PRINT 
10160 RETurn y$ 
10170 END DEFine 


The interesting part is in the function encode$. The RNG is initialised with the secret key value that 
needs to be the same for encoding and decoding. The individual characters of the string to encode 
are then XORed with the resulting sequence of random numbers from the RNG. 


Introduction 
At the end of the last issue, | promised to continue looking at Application Sub-Windows by adding 
some code to our menu enabled program. Unfortunately, due to the current very busy situation at 
work, and a mild dose of tendonitis in my thumb, I'm having to do a lot of one-handed typing these 
days which is slowing me down a lot. To this end, I'm taking a break from application menus for a wee 
while, and this issue, my article will be small ~ but hopefully, perfectly formed ~ looking at how we can 
create and use our own libraries of useful routines with gwasl, 


The Library Code 

The following is the complete code for a small library that allows your own assembly code to clear 
various parts of the screen. | apologise for the briefness of this article, but as | said, I'm typing one 
handed at the moment. The code should be typed into a file named lib_cls_asm or something similar. 


d 
3 A small library to demonstrate the use of same in GWASL ; 
3 It's not particularly useful, it only demonstrates a 3 
3 point! H 


} n AO.L. 3 
3 All. routines assume infinite timeout. 7 
3; All regsiters are preserved, except DO.L. H 
2 e 


; Error codes are returned in DO.L and the Z flag. 


els_screen equ $20 
els_top equ $21 
cls_bottom equ $22 
els_line equ $23 
els_end equ $24 


infinity equ —-1 


? 


j CLEAR_SCREEN - Clears entire screen. j 


3 


I 


clear_sereen moveq #cls_screen, 40 
bra.s just_do_it 


? 
3; CLEAR_TOP - Clears top of screen. 3 


3 


d 


a 


clear_top moveq #cls_top, d0 
bra.s just_do_it 


, 
3 CLEAR_BOTTOM -— Clears bottom of screen. 4 


3 
clear_bottom moveq #els_bottom, dO 


bra.s just_do_it 


; 


j CLEAR_TO_EOL - Clear to end of cursor line. A 


clear_to_eol moveq #cls_end, 


10) 


bra.s just_do_it 


clear_line moveq #c1s_line, 40 


just_do_it movem.1 di/d3/a1,-(a7) 
moveq #infinity, 43 


trap #3 


movem.1 (a7)+,d1/d3/al 


tst.1 40 
rts 


So, you can see that there’s not much to it. 


That's the end of step one. The next step is to assemble the file using gwast in the normal manner, fi 


any errors, and create an output fi 
will be another symbol file named 
format we can use just yet. 


Once all errors have been removed and the source assembled, we are ready to move onto creatin 


our library. In actual fact, half of the 
symbol file into a text file that we 
routines in the library, 


Execute the utility named sym_bin 


familiar if you have used gwasl frequently. Choose option 1 as normal, and type in the path to th 
lib_cls_sym file. 
After a couple of seconds, you can choose the option to exit. Our work is done! 


ib_cls_sym created. We need that file shortly, however, it isn't in 


ibrary is already created ~ lib_cls_bin - but we need to convert th 
can include in our own source code in order to actually call th 


in your gwasl directory. The layout of the screen should look prett 


@ most likely named lip.cls_bin. In addition to the binary file, there 


Xx 


a 


@m 0Q 


e 


D—< 


Sym.bin has taken the binary formatted lib_cls_sym file and created from it a new text file named 
lib_cls_sym_Ist. If you open this in an editor, it will look something like the following: 


CLS_SCREEN EQU $00000020 


CLS_TOP EQU  $00000021 
CLS_BOTTOM EQU $00000022 
CLS_LINE EQU $00000023 
CLS_END EQU $00000024 
INFINITY EQU  $FFFFFFFF 


CLEAR_SCREEN EQU %+$00000000 
JUST_DO_IT EQU *+$00000012 
CLEAR_TOP EQU *+$00000004 
CLEAR_BOTTOM EQU ¥*+$00000008 
CLEAR_TO_EOL EQU %*+$0000000C 
CLEAR__LINE EQU ¥*+$00000010 


You can see that all the equates defined in our source code have been made visible as well as offsets 
to the various routines. These offsets are the actual addresses within the lio_cls_bin file where the 
individual routines start. 

lt would be nice if there was some way for equates etc within a library to be invisible from outside It 
without us having to do too much extra work, however, as far as I'm aware, it’s not possible to define 
an equate as ‘local’ - similar to SuperBasic. What we can do is delete the top few lines leaving only 
the offsets to the routines. Edit the file to delete the lines from CLS_SCREEN down to INFINITY 


Next, create a new file containing these two lines, call it lib_cls_in: 


in wini_gwasl libs.lib_cls_sym_lst 
lib winl_gwasl_libs_lib_cls_bin 


And that's all there is fo it. To use the code simply include the following at the end of your own 
assembly code: 


in wini_gwasl_libs_lib_cls_in 


Obviously, your paths will be different from mine, so change accordingly to suit your own system. 


| have combined the IN and the LIB commands into one single file because | like to do as little typing 
as possible. You need not do this and to use the library, simply add the two lines above into the end of 
your own code at some point. 


To demonstrate the code, all you need is something like this. Not shown in this example are other 
libraries that | use to set colours, open screens etc. 


start bsr open_ser 3; Open a screen channel. Return id in AO 
psr = set_colours 3; Set paper, strip and ink to my defaults 

; 

? 


Preserves all registers except DO.L 


bsr clear_screen ; Clear screen 


in wini_gwasl_libs_lib_cls_in 
in wini_gwasl_libs_lib_defaults_in 
in wini_gwasl_libs_1lib..colours_in 


End Of Chapter 30 

So, that’s the end of this exciting instalment. Hopefully next time il be able to continue where | lefi off 
last time. | should also poini out that George has created a new version of EasyPEasy with some 
changes to make setting up menus dynamically at run time much easier | shall be looking at the 
changes next time. 


Database 
DB 

DBF 

DD 
Debug 


Debugger 


DIL 
DIN 
DIMM 


DIYTK 


Dongle 


DS 
DTE 
DLL 


DOS 
DP] 
DRAM 


Driver 


DTP 


We continue here from where we ended two issues ago. 


An application that stores and manages data e.g. Archive or DB on the QL. 
Data Base, also the term used for the USA equivalent of Archive 
Database file 

Double Density, normally refers to a type of floppy disk or drive 


Examine a program to find out why it or some part of it isn't running as it ought 
to. 


A program which lets you run your program in a manner (usually line by line) 
which lets you examine values of variables etc to help you debug and work out 
why your program isn’t running the way it ought to. 


Dual In Line, normally used when referring to the type of IC sockets used on a 
circuit board 


Deutsche Industrie-Norm, the German equivalent of BS! and ANSI, many types of 
audio and power connectors are often referred to as a ‘DIN’ plug or 'DIN' socket 


Dual Inline Memory Module, a type of memory card used by PCs using both 
sides of the card 


Do It Yourself ‘Toolkit. Name used fo refer to a long running series of articles by 
Simon Goodwin in QL World magazine, where he wrote extensions software for 
the QL as individual files which you could bundle any of them together into a 
boot file, hence the DIY name 


Term used to refer to the plug in cartridge issued with the first QLs where part of 
the operating system was held in a small ROM cartridge plugged into the ROM 
expansion slot at the back of the QL. The term ‘Kludge’ was sometimes used as 
a synonym. Both terms were originally used by early reviewers of the QL, 
Outside the QL scene, this term has also been used to mean either a plug-in 
cartridge used like a key, without which the computer or a particular software 
will not work unless you have the key (or ‘dongle’. More recently, the term 
‘dongle’ has been used to refer to the plug in wireless networking devices for 
PCs, for example. 


Double Sided, normally refers to a type of floppy disk or drive 
Data Terminal Equioment, RS232C communications term 


Dynamic Link Library, an interface allowing a programmer to use code from 
within his/her own application 


Disk Operating System 
Dots per inch, used to describe print density on a printer, for example 


Dynamic Random Access Memory. The information stored in DRAM is lost if the 
power is turned off 


Name given to a piece of software which allows the computer to control a 
specific type or piece of hardware connected to that computer. 


Desk Top Publishing 


ED 


EE 


EGA 


E-MAIL 


EPROM 


EEPROM 


EPROM Slot 


Emulator 


Endian 


Environment 
Variables 


EOF 


Equivalent 


Error 


Exception 


Extra Density or Extra-high Density, refers to the 3.2 megabyte floppy disks for 
the QL, or their disk drives 


Extended Environment, a term used to describe the combination of PTR_GEN, 
WMAN and HOT_REXT (or the equivalent in SMSQ/E) which give you a system 
which enhances your QL by saving and restoring window contents, hotkeys, 
standard menus and so on 


Enhanced Graphics Adaptor for the PC, now largely superseded, this term is stil 
used to refer to a particular type of screen display. On the QXL, for example, an 
EGA display mode refers to a 640x350 pixel display. 


Electronic Mail, commonly used by Internet enthusiasts to send messages etc. to 
each other via the Internet 


Erasable Programmable Read-Only Memory, a special memory chip, which can 
be programmed with certain information (e.g. some extensions for the Super- 
BASIC language). Once programmed, you can only read information from it. If you 
expose a little window on it to strong ultra violet light (in a sealed container of 
course, you can buy special ones for this job) it will erase the program and you 
can then user a programmer device {6 save new information to it 


Electrically Erasable Programmable Read-Only Memory, (see above) but pro- 
grammed and erased electrically using field emission known as ‘Fowler-Nordheim 
tunnelling’ who first proposed the method 


Term used to refer to a connection on the back of a QL which allows you to plug 
in a software ROM cartridge or small circuit board containing a ROM or EPROM 


A program which runs on one computer and allows that computer to run 
programs designed for a different system. For example, QL2K is a program 
which runs on a PC in Windows and runs QL software on the PC. 


Refers to the layout of bits in a computer system, specifically whether the low 
end or high end bits and byte come first or last. A PC, for example, is Little 
Endian (which means little end of a value first), while processors such as the 
68000 series are Big Endian (which means that the high value part of a number 
comes first). 


System which allows names to be defined and given values by one program (c.g. 
SuperBASIC) and which can be accessed by other programs. Provides a means 
of setting defaull values in a boot program for example, which can be detected 
by later programs. The Environment Variables software was originally supplied 
with the C68 C compiler software. 


End of file. The EOF command is used to check if we have reached the end of a 
file yet. 


As distinct from equals, this means that values are sufficiently close to being 
equal that to all intents and purposes they should be treated as equal. In QL pro- 
gramming, this is indicated by use of the double equals ("==") symbol to indicate 
that the values are ‘approximately equal’. For strings, this means that lower and 
upper case are treated as being the same (e.g. IF a$="me’ would match ME, Me, 
me and mE. For numbers, it is when values are so near to being equal to within 
several decimal places, according to Jan Jones in her book ‘QL SuperBASIC 
The Definitive Handbook’, x==y will be true if (x-y) = (y*1E-7), where (x-y) means 
the absolute or positive value of x-y 


When something in a program has gone wrong, the computer may tell you with 
an error value such as -15 or the message ‘bad parameter’ when a value to 
something is not in the range expected. 


A hardware condition triggered when something goes wrong in processing, for 
example an altempt to divide by zero, or the QL trying to access memory at a 
non-existent address. 


Execute 
EXIT 
Expander 


Expansion Slot 


Start a QL machine code program {as distinct from running a SuperBASIC pro- 
gram). 

Name of a keyword or act of leaving a loop structure such as a FOR or REPeat 
loop. 


A plug-in circuit board for a QL which adds facilities such as a memory expan- 
sion, a floppy disk interface, hard disk interface or any combination of these. 


Term which refers to a connection on the left hand side of the QL into which you 
can plug an expansion card such as a floppy disk interface or memory 
expansion device. 


Extended Environment See EE above. 


FDD 
File Header 


FLP 


Forward Slash 
Frame Rate 


FTP 


Function 


Fuzz 


GAL 


Floppy Disk Drive 


A short list of data about a file, which either precedes the main file itself, or may 
be held separately on a disk drive, which holds information such as the size of 
the file, date it was last updated, file type and so on. 


Abbreviation for Floppy Disks. Most QL disk systems refer to disk drive number 1 
as FLPi_ for example. FLP is an example of a directory device name. 


The ‘/’ symbol on the keyboard, as distinct from the Back Slash symbol "\. 


A frame rate is the number of pictures shown per second and is also the time 
units used for the INKEY$ and PAUSE keywords. In most countries this corres- 
ponds to 1/50th second, while in the USA for example it might be 1/60th of a 
second. 


File Transfer Protocol, a term for a method to transfer files via the World Wide 
Web 


A block of code, usually given a name, which is used to perform one or more 
specific tasks (usually calculations) within a program and return a result value. 
Think of it as a building block for a program. It can be called from other places in 
a program several times by different parts of a program, to avoid having to 
rewrite the same code over and over again. 


Term used to describe one of the parameters of a Ql. BEEP sound command. 
The ‘Fuzz’ value (0-15) describes how ‘fuzzy’, ‘blurred’ or ‘distorted’ the sound 
becomes when you use values of 8 to 15 in a BEEP command for the Fuzz 
parameter. 


Gate Array Logic, a type of logic chip used in the Qubide, for example 


Gigabyte, for 1,024 Megabytes, used io indicate the capacities of modern very 
large hard disk drives. Some hard disk manufacturers tend to use Gigabyte to 
mean 1,000 Megabytes instead 


Gold Card, an expansion card for the QL giving a number of additional ports 


Graphics Device Interface 2. The name for the system which allows more 
colours than the standard QL four or eight on the screen 


Graphics Interchange Format, a graphics file format licensed from CompuServe 


A type of logic chip, as used on the QXL for example. Usually the chip which 
controls the interaction of other peripheral chips 


General Public Licence, a type of licence published by the GNU project. It usually 
allows you to run a program, to study how a program works, modify it, give 
copies free to others, improve the program and release the improved version. 


Graphics Processing Unit, a single chip normally dedicated to 3D graphic 
environments 


| have a recurring nightmare. 


| wake up in a cold sweat and discover that it is 
February 2010 again; and the drivers for the 
Ser-USB still have to be written. 


The reason that this particular vision fills me with 
such dread is because now | know what is to 
come. Now | know how many thousands of hours 
it will take to tame the many incarnations of QDOS 
and to force ae year-old serial ports barely fit 
to drive a dot matrix printer to accommodate the 
demands of a 2ist century storage device. And if | 
had known then what | know now .. 


.. But this is a story that begins earfer 


It is October 28th, 2009, | had been in touch by 
e-mail with Tony Firshman concerning my non- 
functioning {then and now) ROMDisQ; somehow 
the discussion had turned to replacement sto- 
rage devices, and | was considering whether a 
simple USB interface would be possible. It was 
then that Tony mentioned the USBWiz, a subject 
that he had broached previously on the QL Users 
List but which | hadn't picked up on. This was 
really the beginning. 


Around that time Memory Lane Computing had 
been incorporated, formed in the wake of my 
taking voluntary redundancy. Although it hadn't 
been my intention to focus on creating new hard- 
ware, back then the idea of producing a work- 
able USBWiz-based storage device for the QL 
was {oo interesting to resist. 


It seemed straightforward. All that would be nee- 
ded was an RS232 to TTL level converter (the 
USBWiz uses TTL serial levels) and a device 
driver. | remember the reasoning process that fol- 
lowed only too well: Let's see ... QUBIDE is public 
domain .. that has all the core directory device 
code that | need .. it just needs the hardware 
specific stuff removed and replaced with calls to 
an interface layer that emulates the IDE controller 
and generates USBWiz commands over the 
serial port. 


How hard can that be? .. 


This is the story of how the Ser-USB drivers 
were written. The highs and the lows (more of 
the latter unfortunately) and a game of mental 
chess played out against the backdrop of multi- 
ple ROM versions, unreliable serial hardware, 


seemingly little interest from the QL. community, 
and operating system design features that ap- 
peared purposely designed to frustrate the 
project. 


This is also a story that almost didn’t happen. 
There were several occasions when | decided 
that the obstacles were just too great and that 
the pursuit of a solution was not only a hopeless 
endeavour but a waste of time, effort and money. 


Here at the end, in the final days of the Ser-USB 
project, when the 2.0 drivers are close to being 
publicly released, and other projects are immi- 
nent, | can look back and take stock. Yes, it pro- 
bably was a waste of money. Viewed in simple 
profit and loss terms, Ser-USB is an investment 
that will never be recouped. On the other hand, 
the code libraries that have resulted from the 
Ser-USB project, the EDDE 2 universal driver 
core, the utilities and extensions; all of these are 
reusable. Already they are at the heart of the 
drivers for the QL-SD and the Q-BUS. The BDI 
driver for Q-ernuLator uses the same core and 
work is advanced on EDDE 3 - a universal plug 
and play driver architecture that will allow new 
device drivers to be created. by anyone with just 
a handful of hardware-specific routines. 


So, from a USBWiz in a tatty black plastic project 
box with tts overheating MAX232 chip mounted 
on veroboard, to custom PCBs and distinctive 
Clear blue enclosures; from driver code that 
flipped into user mode to complete serial 1/0, 
through the unwieldy Queue Manager, to the IOSS 
Retry Integration, Write As You Go map handling 
and the Extended Open Handler of the Ser-USB 
Legacy Driver; from an idea to a product .. this is 
a story ihat surely deserves to be told, 


Part One: GENESIS 

The first Ser-USB prototype was completed on 
the 19th of November, 2009, but it would be a 
further eight weeks before there was anything 
even approaching a device driver 


These pictures show how the original device 
was constructed inside a surplus black plastic 
project box, its level translator circuit and LED 
indicators constructed on veroboard. 


Illustration 2: Inside the Ser-USB prototype 


The very first version of the Ser-USB driver is 
dated ilth January, 2010. It was version 0.01. It 
ran on an Aurora with a Super Gold Card, SMSQ 
2.98, and a superHermes. It couldn't format any- 
thing, but it could copy files and display a direc- 
tory. Very little else worked. 


The work to create this version had started in 
November 2009 with the source code for the 
QUBIDE driver. | knew that the very first thing that 
had to be done was to deconstruct that driver, 
identify all of the hardware-specific code and re- 
place it with code that spoke to the serial ports 


instead. lf sounds simple 
when you say if quickly, but 
there was a lot more to it 
than that. | knew that it 
would be an impossible 
task to rewrite all of the 
hardware-specific code 
piece by piece so | took a 
different approach. | wrote 
an ATAPI emulator layer A 
handful of routines that 
were Called in place of the 
code accessing the IDE 
controller's registers that 
could then map those ac- 
tions onto the USBWiz. 


There was also the small 
problem of a disk drive 
architecture that was built 
around Cylinders, Heads 
and Sectors which had to 
be mapped to Logical 
Block Addresses (LBAs), 
but that could come later. 


Writing the ATAPI emulator 
ayer took most of Decem- 
ber 2009 and continued 
into January 2010. More 
than half of that time was 
taken up simply by deve- 
oping an understanding of 
what the QUBIDE code 
was actually doing. At that 
time all of the coding was 
done on a Windows PC 
with QPC2 and the Quanta 
QMAC assembler. 


The hard work in v0.01 was 
done in a single module 
called usbdev. This con- 
tained the device driver 
initialisation code, a handful 
of control routines and the block I/O functions. It's 
interesting to read the XDEF list of that first 
iteration of the main USBWiz hardware-specific 
module: init, wait_busy, reset_drive, 
read_params, usbwiz_rdsect, usbwiz_wrsect, 
drive_select, drive_link, drive_cemd, 
drive_capacity, drive_rns, drive_wns. 


Only three of these functions were to survive 
into the final production driver: drive_select, 
drive_linkand drive_eapacity. They are still in 
the code today, although they bear no resem- 
blance to their distant ancestors. Perhaps the 
two most important functions, usbwiz_rdsect 


and usbwiz_wrsect (read and write sectors} 
were destined to become hw _read_lba and 
hw_write1ba while drive_rnsand drive_wns 
(Read Next Sector, Write Next Sector) ceased to 
exist when the ATAPI emulator layer was finally 
dispensed with. 


Looking back over that code it is, without doubt, 
a mess. An untidy tangle of hacks and patches 
that somehow worked enough to create that 
very first version and provided me with the justili- 
cation to go ahead with the project. 


What | did not know at that time was that some 
serious problems were being disguised by deve- 
loping under QPC2 and then running on the Au- 
rora with SMSQ and superHermes. Most impor- 
tantly, a tiny little problem concerning device 
drivers that call other device drivers which, in 
turn, are unable to complete transactions atomi- 
cally, | have come to know this as the D3 Curse. 


Register D3 is used to pass a timeout to all Trap 
#3 ([/O) calls. If it has a value other than zero it 
has a special significance; it tells the IOSS (Input 
Output Sub System) in QDOS that the trap should 


Norman's {NDI answers to George's [GG 
comments on Assembler - Part 29 


[GG] In Part 29 Norman deals with what he calls 
a static menu inside an application window. SETW 
is used to produce the required window definition, 


(GG! 1. My first comment is an apology for the 
fact that SETW does not allow a long enough 
name for Norman. A new version to allow the lon- 
gest possible names to be entered is now availa- 
ble. 

[ND] | shall be looking at the new version very 
soon. Thanks for a quick turnaround and fix. 


[GG] 2. At the bottom of page 29 | think the 
number of objects (for the second information 
window) should be 0 and not 0.10. 

IND] Yes indeed. That should have been zero. | 
have actually asked Geoff to put up a correction, 
but that won't be necessary now as this will 
cover it. 


[GG] 3. In step 14 Norman goes through the pro- 
cess of defining the colours for presentation of 
loose items. SETW allows a set of defaults here. 
The reason for that was that | got fed up having 


be retried until either {a} it returns O or an error 
code other than errnc (Not Complete) or {b) the 
specified number of timer ticks in D3 have 
elapsed, -1 has the special significance of telling 
the scheduler to keep retrying forever until {a} is 
saiisfied. 


The problem is that if you have a slow device, 
such as a serial port, the serial driver may take 
hundreds of timer ticks to complete a trap #3 
request, and it won't complete at all unless con- 
trol is returned to the scheduler so that interrupts 
and other housekeeping can take place. But if 
you do specify a timeout in D3 when you make a 
trap 43 call fromm supervisor mode inside a de- 
vice driver, the scheduler gets re-entered and 
this causes big problems! The recommended 
method is actually to use a zero timeout and to 
keep retrying the call in your own code with a 
loop. Unfortunately, if you do this with the stan- 
dard QL serial port driver the call will never 
complete. 


And that was the problem at the heart of the 
Ser-USB driver, That was the dreaded D3 Curse! 


to type in all these colours, several of which 
would turn out to be not what t wanted. Perhaps 
SETW should have allowed these defaults to be 
configured, 

[ND] That would possibly help when the users 
have defined their own colour scheme. | simply 
went through each step in order that we are all 
‘on the same hymn book’ as it were. 


{G@] 4. On page 31, Norman suggests that the 
resultant asm file should be saved somewhere. | 
agree with that. It is only too easy to switch off 
without saving the file. It was to prevent such 
annoyances that it was arranged that SETW can 
be configured to give directories for the saving 
of all three of the files which it produces. | find it a 
great comfort. 
INDI | always do my rough work on RAMI or 
RAM2, so even with the configuration options 
correctly set, !d still be there. It's something I've 
always tended to do since | obtained my first 
Tump Card all those years ago. Still doing it 
today. | used to forget to copy the file safely 
years ago, but | seem to be better al remember- 
ing now! 


[GG] 5. | noticed with surprise on page 34 that 
he flag in the window definition wd0 was 258. 
This indicates a shadow size of 2 combined with 
he instruction to disallow the arrow keys moving 
the pointer This means that Norman was using 
an old version of SETW. The correct value of the 
flag is given for version 7.06 or later The value 
should be 2 and not 258. This error also applies 
o ‘clear flag’ in anpwO on page 49. This should 
be 0 not 256. 

IND] Hmmm. | was sure Id upgraded SETW. 
However, Il be using the latest version from now 
on so it shouldn't be a problem in future. 


[GG] 6. On page 35, in discussing how the menu 
objects are defined, Norman, quite rightly indi- 
cates thal they can be of any of four types, text, 
sprite, blob or pattern. I'm afraid that | thought it 
unlikely that anyone would really want anything 
but text in a set of menu items so SETW only 
allows these. This greatly simplifies the use of 
SETW in this area. I'm afraid also that SETW 
simply puts the text items where it can in the 
window provided. If there is not room for them all 


then scroll bars are automatically produced. 

IND] While the above may be true, the fact is, 
SETW makes the initial generation of the code to 
build menus etc quite easy, It is a matter of a few 


In the first three parts of this series we have 
joked at the principles of the I2C bus and some 
of the devices that can be used. Such as parallel 
and AD/DA interfaces, RTC (Real Time Clock), 
RAM (Random Access Memory) and a digital po- 
entiometer. This time we shall look at a practical 
use for the PCF8574 parallel device we looked at 
in part one. 


In this article | am going to show you how you 
can drive a LCD (Liquid Crystal Display). In part 
one, | showed a circuit to be able to demon- 
strate input and outputs to and from the 
PCF8574 device. In this application we only 
need to use the output function of the PCF8574 
since we are only going to drive the LCD dis- 
play at a simple level. However the input/output 


capability of the PCF8574, can fully exploit all | 


the available functions of the LCD displays such 


as these. See the HD44780.pdf in the referen- | 


ces below, for further information on this. 


minutes fo change things around to make diffe- 
rent menu item types, of dimensions etc. SETW 
does the huge majority of the hard work. 


[GG] 7. Norman shows how you can have 
indexes. Well, | await with enormous interest to 
see the program that actually produces these. | 
have tried, and failed, to have anything ap- 
proaching an index appear on the screen using 
WM_INDEX. | even stepped through WM_INDEX 
using QMON and noticed the complete lack of 
index production. To find out whether indexes 
were produced by some other program in the 
system | searched the whole of the set of .asm 
files in SMSQ/E source code for the few items 
such as wwa_xind (which is the label in an appli- 
cation window attached to the pointer to the co- 
lumn index list). Answer came there none. 

[ND] Yes. George and | have had an off-line dis- 
cussion on the Index problem before Christmas. | 
was working on the fact that the QPTR manual 
was correct and accurate. George did what he 
does best and dived into the actual code to see 
what is working and what is not. George's fin- 
dings show why there are no PE programs using 
indexes around, Simply put, they are not imple- 
mented. 


LCD's (Liquid Crystal Display's) come in many 
different sizes, for example common ones are 8 
characters by 2 lines, 16 Characters by 2 lines, 16 
characters by 4 lines, 20 character by 1 line, 20 
character by 2 lines and 40 character by 2 lines. 
They are easily available from the likes of Farnell 
and RS via mail order or via their websites. There 
are other suppliers as well, 


“Some example LC 


One of the big advantages of these displays is 
that they have a standard interface and protocol 
using ihe Hitachi HD44780 driver chip. So any 
software you write will work with all versions of 
the displays. The only consideration is how many 
characters you wish to display at any one time, 
which should govern the size of display you use. 
LCD's come with or without back lighting - it is 
your choice which to use. However back lit ver- 
sions do tend to be more expensive. Also check 
the display you are using has the HD44780 chip, 
Most do, but it is worth double checking, 


Another word of caution, some modules require 
as low as ~7V on their Vee (Contrast) pins, these 
versions will not work in this circuit - double 
check the datasheet for the device 


The standard connection layouts of 
the displays are shown below. There 


10 b3 Data Bit 3 

di D4 Data Bit 4 

12 D5 Data Bit 5 

13 D6 Data Bit 6 

14 D7 Data Bit 7 

15 BLA (If Fitted) Back Light Anode 
16 BLC (if Fitted) Back Light Cathode 


Below you will see the circuit diagram for the I2C 
to LCD project. As usual refer to part one which 
shows the connections to the BV422i USB to 
12C converter. The BV4221 provides the 5V sup- 
ply, SCL, SDA and GND connections required. So 
the circuit is self powered from the BV4221 USB 
to I2C converter. 


coor 


LCD Display 


are some variations out there, so fe = 
again do check the datasheet for the 3 aim fa Ue OR TCL LATA 
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The pin out functions for all LCD types is shown 
below: 


Pin no Name Function 

1 Vss Ground OV 

2 Vdd +ve Supply (5V) 
3 Vee Contrast 

4 RS Register Select 
5 R/W Read/Write 

6 E Enable 

7 DO Data Bit 0 

8 D1 Data Bit 1 

9 D2 Data Bit 2 


The circuit above is designed to exploit the full 
capabilities of the LCD module. However in this 
example we will only be sending data to the 
module, not reading any data from the module. 
So plenty of room for you to experiment. 


The potentiometer Ri is the display contrast 
control, this can be a preset type, since once set, 
it does not need to be touched often. Note: with 
multi line displays, this may need to be adjusted if 
you change the number of lines to be displayed. 
So for example if is a two line display and you 
change it to one line operation from two line 
operation then the contrast will need adjusting. 
Best to start off with the pot turned the GND end 
of the travel to start with, then adjust for best 
contrast once you have run the program. You 
may see the top line of the display go dark at 
switch on, this is normal until the LCD display has 
deen initialised, this will be explained later Do not 
adjust until the display has been initialised and is 
displaying the characters you have sent it. 

You will see from the above circuit diagram that 
we are using 7 bits from the PCF8574 to control 
and send data to the LCD module. These LCD 
modules have two modes of operation with 


regards fo data. The first being 8 bit words sent 
in one go. This requires all LCD data pins to be 
driven. That would then require two PCF85/4, 
one for LCD control and a second fo provide the 
data. Not the most efficient way. In the LCD's se- 
cond mode of operation, we can use one 
PCF8574, the lower 4 bits being used (actually 
only 3 are used, there is a spare pin), for LCD 
control and the upper 4 bits for data. The data is 
now sent as two 4 bit nibbles, providing the 8 bit 
word the LCD requires. 


The spare line from the PCF8574, could via a 
transistor (not shown) be used to control the 
back light of the LCD, if you use a LCD module 
fitted with one. Do not try to drive the back light 
directly from the PCF8574, since a fairly high 
current is required, 


There is a process that your software needs to 
perform to get the LCD display working. First the 
LCD display needs to be initialised. See line 1120 
{LCD_init) onwards in the listing below. The first 
process is to tell the LCD Display to work in 4 bit 
mode, which is command,'32’. This is sent as a 
single 8 bit word, since this is D5 bit =1 and the 
rest of the bits are 0, this is one of the reasons 
bit 0 to bit 4 has to be grounded so they really 
are 0. Next we have to set the LCD to accept 8 
bits (as 2 nibbles, in this case) and that the dis- 
play, in this case, is a two line one. The numbers 
sent are now split into two, the first nibble that is 
the last 4 bits then the second 
nibble which is the first 4 bits, 
All commands and data have 


140uS 
| 


Read/Write 


R& (Register Select) 


450uS8. / 
ENN. 
. Data Pa 


200us 
LGD Display Timing Diagram 


So commands and data is sent as follows: 


Command or Data EN Line RS Line 
0 Oo ft 

0 1 of 
Data ist Nibble al 1 
Data 1st Nibbel 0 ab 


Repeat for the second data nibble. The action of 
the EN line falling to zero(0), transfers the data 
within the LCD display, 


The enable line is P3 from the PCF8574, so 8, 
(variable=en) is added to the data number to 
transfer the data in the LCD display. All the control 
codes are show in the table below. 


to be sent this way from now 
on. The next command sent 
set the LCD display to, display |Reum 
ON, cursor ON and Cursor 


Clears entire display and sets 
IODRAM address to OOH, 
Sets DDRAMI address to OOH tn 
AG and returns shifted display to 
~ fits original position. The contents. 
lof DDRAM rémialh unchanged, 


blinking. The last command to 
initialise the display is Entry |set 
mode, Cursor increment and 


Sels cursor move direction and 
enable the shift of entire display, 
These operations are performed 
during data write and read. 


SH 


No display shift. All the Com- 
mands are shown in the table 
below. After much experiment- 
ing and referring to the data [om 


Sef ON/OFF of entire display 
8 (D), cursor ON/OFF(G}, and 


blinking of cursor position were. 
B). 


Ioves cursor and shifts display 
> feithout changing = ODRAM| Sens 
contents. 


sheets, the data is sent in a |~ 
given sequence so at to repli- 
cate the timing diagram shown 


Sets interface data length (DL: 
.. fS-bit/4-bit), numbers of display 
line (N: 2-fine/1-ine), and display! 
font type (F; 5x4 tdots/Sx8dots) 


at the top of the next column. — [addess _| ° 


Sel CGRAM address in address 


Now the timing is not impor- 


fant, in fact the timings shown 
are minimum values as de- 


Read Busy 
Flag and 0 
Address 


Reads busy flag (BF) Indicating 
intetnal operation js being 
ipeiformes and reads address. 
counter contents, 


scribed in data sheets. How- 
ever the order in which the 
control and data lines are de- 


Write data| 


Wrile data (nto internal RAIA 43us 
(DDRARVCGRAM). 


Read deta 
from CG on 4 


livered are important. 
OD RAM 


Read data from internal RAM 


D3 | 02 | Dt | BO (ODRAMCGRAM). 43us 


Now the text can be sent to the — [S€foo00/o00s foo10 [0081 [0100 [ot0s forzo ors [x00 001 | 1010 soit] 4100] +104 1110] 1144 


LCD Display. This is done in the es] | Dee tes] ee 
LCD_message procedure. The en-  |°| "4s eELHE : 

lire character set is also shown in ce i 1 EY cele 
the diagram to the right. SOON RAM la | abe | PA lh 


co Ta ae ae 
0010 | RAM | 


The following listing is just to de- 
monstrate how to drive a LCD dis- 
play in a basic manner. It has been 
deliberately slowed down so you 
can see the display respond to the 
commands, Clearly in normal ope- 
ration you do not need to do this. 
The listing is fully annotated so you 
should be able to follow what is 
going on. 


10 REMark LCD test routines 

20 init 

40 OPEN#3;ser2ir:REMark isignor hardware handshake, r=raw data 

50 PRINT#3;CHR$(13);:REMark Carriage Return to set the baud rate in the USB to I2C converter, 
required on first pass to initialise USB to I20 converter. 

60 printreply:PRINT "Reply from sending CR." 

70 PRINT . 

80 PRINT#3;"V";CHR$(13);:REMark Command to USB to I2C coverter for firmware version. 

90 PRINT "Return USB Converter Version Number:-"; 

100 extract_read_data:PRINT d$;:print_reply:REMark Prints version number reply from USB to 12C 
converter 

110 PRINT 

120 PRINT#3;"D"; CHR$(13);:REMark Sets USB to I2C coverter to receive decimal numbers, default is 
hex numbers. 

130 PRINT "Decimal Mode Selected" 

140 print_reply:REMark returns a device address. 

150 PRINT 

160 : 

170 init_LcD 

180 LCD_message "QLToday" 

190 move_second_line 

200 LCD_message "Forever" 


280 PRINT "End "'s CLOSE#3 :STOP 
290 : 

1000 DEFine PROCedure init 

1010 CLS 


1020 BAUD 115200 
1030 ram=174:REMark PCF8570 address, all address links open. 
1040 paralleli=126:REMark PCF8574A address, all address links open 


1190 
1200 
1210 
1220 
1230 
1240 
1250 
1260 
1270 
1280 
1300 
1310 
1320 
1330 
1340 
1350 
1360 
1370 
1380 
1390 


1400 : 


1410 
1420 
1430 
1440 
1450 
1460 
1470 
1480 
1490 
1500 
2000 
2010 


2020 
2030 
2040 
2050 
2060 
2070 
2080 
2090 
2100 
2190 
2200 
2210 
2220 
2230 
2240 
2250 
2260 
2270 
2280 
2290 
2300 
2310 
2360 


parallel2=78:REMark PCF8574 address, all links open 
adda=158:REMark PCF8591 address, all address links open 
rtc=208:REMark DS1307 real time clock, one fixed address with this device. 
digpot=94:REMark DS1803 Digital Poteniometer, all link open 
DIM tdata(7) 

DIM days$(7,3) 

RESTORE 

FOR a=1 TO 7 

READ d$ 

days$(a)=d$ 

NEXT a 

DATA "Mon", "Tue", “Wed" "Thu", "Fri, "Sat", "Sun! 

END DEFine init 


DEFine PROCedure print reply 
ogaun 

REPeat loop 

a$=INKEY$ (#3) 


PRINT b$; 

IF a$=">"' THEN EXIT loop 

END REPeat loop 

END DEFine print_reply 

DEFine PROCedure non_print_reply 
oda 

REPeat loop 

a$=INKEY$(#3) 

bg=a$ 
o$=c$&b$ 
IF ag=">" THEN EXIT loop 
END REPeat loop 

END DEFine non_print_reply 


DEFine PROCedure extract_read_data 
dgamt 

REPeat data_loop 

a$=INKEY$(#3) 

b$=a$ 

ag=d$abd 

IF a$=CHR$(10) THEN EXIT data_loop 
END REPeat data_loop 

END DEFine extract read_data 


DEFine PROCedure init_LCD 
rs=2irw=4;en=8:REMark rs ig register select, rw is read/write (only need for reading 
display rom, enable to transfer data to LCD display. 

PRINT#3;"s—";paralleli;" 0 p";CHR$(13):REMark set all outfrom from PCF8574 to low, 
non_print_reply 
load_LCD 32:REMark Sets LCD to 4 bit mode 

load_LCD 32:REMark Sets LCD to data length to 8 bit, ist nibble 

load_LCD 128:REMark Sets LCD to data length to 8 bit, 2nd nibble 

load_LCD 0:REMark Sets LOD to Display ON, Cursor ON, Cursor Blicking, 1st nibble 

load_LCD 240:REMark Sets LCD to Display ON, Cursor ON, Curgor Blicking, 2nd nibble 

load_LCD O:REMark Sets LCD to Entry Mode, Increment Cursor Position, No Display Shift, 1st nibble 
load_LOD 96:REMark Sets LCD to Entry Mode, Increment Cursor Position, No Display Shift, 2nd nibble 
END DEFine init_LepD: 


DEFine PROCedure LCD_message(message$) 
mlen=LEN(message$) 

FOR me=1 TO mlen 

ms$=message$(meo) 

ms=CODE(ms$) 

nibi=(INT(ms/16)) 
nib2=ms—(nib1*16) 
nibi=(nib1%16)+rs 
nib2=(nib2%16)47rs 

load_LOD nibi 

load_LCD nib2 

PRINT ms$;" "jms;" "j;nib1;" ";nib2 


ant Information 
gy Services 


pesven, seat 


Welcome 


Quo Vadis Design sells software for the Sinclafr Quantum, 
Leap computer (QL) and variants including a neve O/S called 
MSQE, 


‘Softveare emutations of tha QL naw exist which can run on a 
PCRlac with Windows Linux ar Mac Operating systems. 


News 


#QVD QL News Blog - keep up to date 
News Blog 

/osrzong . 
# Quo Vadis Design Website Launched 


01/02/2009 


aJeMYOS F/OSINS/SOdD/10 


Special Offers available from 
Jochen Merz Software for its 
25 years in QL Trading 


Check the QL News Blog on 


our website for the special 
offers 


The QL magazine Y 
for all Q(DOS, QL, fF 
SMSQ .. 


NEXT me 


PR 


PR 


PRIN 


END DEFine LCD_message 


PRINT led_data 


END DEFine load_LCD 


DEFine PROCedure move_second_line 

load_LCD 192:REMark Move to start of second line ist nibble 
load_LCD 0:REMark Move to start of second line 2nd nibble 
END DEFine move_second_line 


DEFine PROCedure load_LCD(1cd_data) 

NT#3;"s—";paralleli;" ";1¢ed_data;" p"";CHR$(13) 

PAUSE 4:non_print_reply:REMark delays required for the USB to I12C and display to respond 
NT#3;"s—";paralleli;" ";led_dataten;" p";CHR$(13) 

PAUSE 4:non_print_reply 
#3;"s—";paralleli;" ";led_data;" p";CHR$(13) 
PAUSE 4:non_print_reply 


If all goes well you should get a display like this. 


So now is the tim 


@ for you to ex- 


periment with the initialisation as 
well as the characters, Also you 
can program the LCD Display with 


your own charac 


on the web abo! 
displays. So lots 
ike scrolling disp 
is just fo get you 


ext time we w 


ers, read the re- 


erence documents on how to do 
his. There is lots of information 


ut these clever 
o have fun with, 
ays. This article 
going. 

il take a break 


rom the l2C in 


erface and will 


look at using the parallel printer 


port on QXL, Q| 
and Super Gold 


PC2, Qemulator 
card QL’s, as a 


simple output port and show 
more examples of how to drive 


LCD displays. 
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tively been ‘dead’ for many years, we are mostly 
tinkerers by nature. QUANTA, the long lived and 
much loved user group, stands for QL Users And 
Tinkerers Association, so, the Raspberry Pi 
should appeal to quite a few of us, 


Simon Balderson/Bryan Horstmann were the first 
to bring this new device to the QL Users list back 
in June 2011 which was not the first I'd heard of it 
as I'd seen the video of the device on the BBC's 
very own Rory Cellan-Jones’ blog at 

http://www, bbc.co.uk/blogs/thereporters/rorycellanjones/ 
2011/05/a_15_computer_to_inspire_young.html. 


The device has been designed and built by a 
number of people including one David Braben - 
the same David Braben who created Elite, way 
back in the eighties, for the BBC Micro. 


The Raspberry Pi Foundation 

The Raspberry Pi Foundation is a charity whose 
aim is to get kids programming again and came 
about after it was discovered that students 
starting courses in computing at university 
couldn't actually program. IT ‘education’ these 
days consists of learning how to use Microsoft 
Office (other - and better - office suites are avai- 
lable of course) which is fine if you want to be a 
typist or secretary, but of little use in Computer 
Science for example. 


On the main website, the About Us page details 
the background of the Raspberry Pi and how it 
came to be. The following is not a direct copy of 
that page, but is a brief introduction to the 
Foundation and the people involved. If you wish 
to read more, head over to the website. (See 
below for links and URLs} 


Eben Upton is a hardware guru and basically 
started it all when he was still in Academia. Appli- 
cations for the Computer Science courses at the 
University he worked at, were dropping off and 
the skill sets of the applicants was falling. He built 
a number of prototypes over the years - some of 
which you can see on the web site. 


Around 2008, Eben and a group of 


ike minded 


friends and colleagues got together and started 
the Foundation. This group of people became the 
trustees of the charity. 


David Braben is a ‘tock star’ games designer and 
has a contact book ‘as long as your arm’. He has 
been responsible for much of the publicity the 
Foundation has received and for raising sponsor- 
ship deals to help the charity. 


Jack Lang, a Cambridge academic and business 
angel - who worked on the original BBC micro all 


those years ago - runs the business side of 
things and is the guardian of a warehouse full of 
components ready to be assembled into Rasp- 
berry Pi boards. 


Pete Lomas is the MD of a hardware design and 
manufacturing company. He has been responsi- 
ble for designing and building the early boards 
and for minor bug-fixes to the current beta 
boards on Ebay. He also has a natty line in tartan 
trousers! 


Professor Alan Mycroft and Dr Rob Mullins, both 
from the Cambridge University Computer lab, 
have provided much of the educational direction 
for the project. 


Liz Upton, wife of Eben, is not a trustee, but 
volunteers for many tasks such as photography, 
making the videos you see on the web site, 
moderating the forurn and generally answering 
the same questions over and over from people 
who don't read the FAQ, 


Specifications 

The Raspberry Pi comes (or will, early in 2012 it 
is hoped) in two flavours - much like the BBC 
Micro from the eighties - the Model A and the 
Model B. 


The Model A is expected to cost around $25 or 
roughly £16 while the Model B is intended to be 
around $35 or £22 - cheap enough to simply 
replace if you break it. The specifications of the 
two models are: 


The Pi is 85.60mm by 53.98mm by 17mm, with a 
little overlap for the SD card and connectors 
which project over the edges. It weighs 45¢. In 
other words almost identically sized to a credit 
card. There is not a case - you are expected, if 
you wish, to supply/build your own, It is hoped to 
supply cases at a later date. 


Power is from an easily available 5V micro-USB 
power supply much loved of mobile phone manu- 
facturers and most households should have at 
least one lying around! Power can also be sup- 
plied over the GPIO pins on the board. Power 
supplies are not supplied in the box with the Pi. It 
is predicted that the Pi will also run off 4 AA bat- 
teries. 


Power usage is 2.5 W for the Model A and 35 
for the Model B - as tested on the alpha boards. 
The final specification and power usage may go 
up as well as down. (As they say!) 


etworking is via a 10/100 wired Ethernet on the 
Model B only. The Model A has no on board net- 
working. In both cases WiFi networking will be 
available via a USB Dongle - which you will sup- 
ly yourself. 


p 

The Model A has one USB connector while the 
Model B has two, You may have to supply a 
small USB hub to get all your devices connected. 


The processor is an ARMI1 device. This means 
that it will not run Windows programs compiled 
for Intel processors. The CPU runs at 700MHZz - 
which doesn't sound much, but watch it in action 
on the web site before complaining! The whole 
lot is actually a System On a Chip (SOC) and is all 
wrapped up in a single Broadcom BCM2835 chip 
consisting of the CPU, GPU, DSP and the 
SDRAM. 


The SDRAM 
memory is 128 
Mb on the 
Model A and 
256 on the 
Model B. 

ArchLinux, De- 


bian and Fedora 
Linux will be 
supported from 
day one. It is 
also hoped to 
see support 
from other Linux 
distros later In 
addition, there 
ight be a 
iscOS release for the Pi. The OS will be sup- 
ied on an SD card and other cards preloaded 
ith different OSs will also be on sale. it was 
originally intended that Ubuntu would also be 
available but because of issues with newer 
releases of Ubuntu and the ARM processor 
Ubuntu might not be available initially. Anything 
compiled for the ARMv6 CPU should work. 


SUDS 


Sound is output via the HDMI connector to your 
TY of via a dedicated 3.5mm stereo socket on 
the main board. There is no sound input, but as 
ever, a USB device such as a microphone will do 
the necessary for you. 


Video is available on the HDMI or composite out- 
puts. VGA is not available though, although it is 
said that DVI-D will be. 


D output is the full 1080p standard. 


H 

There is no keyboard and no mouse supplied. 
You are required to connect your own via the 
USB interface. You can buy a decent quality, 
cheap keyboard and mouse from Asda or a 
similar outlet. 


Expansion boards are in the pipeline. The first is 
the "Gertboard’ names after Gert, one of the 
designers and the second is a Real Time Clock 
board - the Pi doesn't have an RTC built in. 


So What Is It? 


The Raspberry Pi is a small computer system 
that is hoped, will interest kids in starting to 
actually write their own programs again - like we 
all did back in the early eighties with our 
Spectrums, and QLs. Some people had 


Commodores as well, I'm told, but they have 
feels now! It will look remarkably similar to 
this: 


Image courtesy of the Raspberry Pi Foundation. 
Used with permission. 


Kids nowadays don't know how fo program, ICT 
at school is nothing more that learning to use 
Word or Excel (Your schooldays are ‘sponsored’ 
by Microsoft - go figure!) and industry needs 
people who can program, not typists. Granted, 
typing skills are a good thing - | still use three 


Kaiser-Wilhelm-Str. 302 Fax +49 203 502012 | 
47169 Duisburg, Germany EMail: SMSQ@J-M-S.com 


QPC2 Version 3 + SMSQ/E Software QL-Emulator for PC's 

QPC2 Verston 3 - Upgrade from QPC2 Version 2 

QPC2 Version 3 - Upgrade from QPC2 Version 1 

QPC Print - printer emulation driver for QPC .... 

BUNDLE: QPC2 and QPCPrint 

Agenda Agenda program for WMAN and Prowess 

Suqcess Database front-end for WMAN ... 

QD2003 Pointer-Environment-Editor 

QD2003 Upgrade from Version 9 and older .. 

QMAKE Pointer-driven MAKE for GST/Quanta Assembler .. 

BASIC Linker as 

WINED Floppy/Harddisk Sector- & File-Editor .... we [V1. EUR 14,90 
FiFi Il File-Finder - Extremely usefull ..........00e ww (V4, EUR 14,90 
FiFi Upgrade from Fifi Version 3 or older ..[V4. EUR 9,90 [5 
EPROM Manager _ ‘ EUR 14,90 
QSpread2003 Spreadsheet Program i : EUR 29,90 
QSpread2003 Upgrade from Version 3 and older... wo [V4. EUR 14,90 
QPAC | Utility programs i E EUR 19,90 
QPAC II Files, Jobs & other Things w{V 1. EUR 29,90 [& 
QTYP II Spell checker .. wa ( V2. EUR 19,90 ff 
QPTR Pointer Toolkit 1. [VO. EUR 29,90 
DISA Interactive Disassembler . ww [V3, EUR 29,90 
CueShell w[V2, EUR 29,90 
CueShell for QPC f EUR 14,90 |g 
SER Mouse software mouse driver for serial mice EUR 10,00 § 
EasyPTR Version 4 

EasyPTR Version 4 - Upgrade from earlier versions 

QDT - QL Desktop program 

QMENU Version 8 - with new, printed Manual [v8.02] 

QMENU Version 8 - Update from earlier Versions, also with printed manual 

asia Version 8 - New/Update for QL Uae subeerlBEre: with ere manual ONLY BUR. 14, 90 


We accept VISA, MasterCard & Diners Club online and offline! Details for money transfers: 
¢ Deutschland: Jochen Merz, Account 493 50 431, Postbank Essen, BLZ 360 100 43 
* Osterreich: Jochen Merz, Account 85055317, PSK Wien, BLZ 60000 
© Switzerland: Jochen Merz, Account 60-690080-4, PostFinance, Clearing-Nr 09000 
¢ The Netherlands: Jochen Merz, Gironummer 3258439, Postbank NL Amsterdam 
© and from ail other countries in EUR with IBAN and BIC to account 
Jochen Merz, Deutsche Postbank AG, IBAN: DE21 3601 0043 0611 1004 37 / BIC: PBNKDEFF 360 
* UK customers can pay in £ (convert EUR prices above to £ by multiplying with 0.89) to 
Jochen Merz, Account 83795395, Citibank UK, Sort code 30-00-45 
or send cheques in £ - no fee for UK sterling cheques! 
¢ US customers can pay in US$ (convert EUR prices above to US$ 
by multiplying with 1.36) - no fee for US cheques in US$! a 
If you wish to pay via paypal, send money to Paypal@J-M-S.com cheaves 1 


IF YOU WISH TO BUY ANY OF THE ABOVE ITEMS AT THE 
Vienna MEETING, PLEATE LET ME KNOW IN ADVANCES ; 


fingers after 30 odd years in IT - but programming 
skills are desperately short of supply in the UK. 


This lack of programing skills was noticed and 
the Raspberry Pi Foundation was set up in an ef- 
fort to try and reverse the trend. It must be popu- 
lar the current government have jumped on the 
bandwagon as well. 


Remember the days when you plugged in your 
home computer, waited for it to boot up, and then 
sat there looking at a prompt that said "Ready" or 
similar? Those days are back again. The Rasp- 
berry Pi will give you the ability to start doing 
something straight away without needing to pay 
huge amounts of money for a development 
system. 


On the Forum, there is many a discussion about 
the ideal language for beginners - BASIC takes a 
hammering as being ‘unsuitable’ for Beginners. | 
think they are wrong - and I've told them, but 
each of us has our own opinions. Python - not a 
language | would teach beginners - seems to be 
quite popular and is, to its credit, as ‘instant’ as 
BASIC in getting things done quickly, 

It would be nice to get SuperBasic running on a 
Pi - that's a project for another day - bearing in 
mind that the Original S*Basic was written in 
pure 68000 Assembler and that oe will not 
run on an ARM chip - a complete rewrite would 
be required, 


The whole purpose of the ae Piis to get 
us all back into the habit of writing our own pro- 
grams to do ‘stuff instead of buying something 
that does it for us. This is right up the alleyway of 
all us tinkerers, 


| have to admit that I'll be buying at least one of 
these devices when they go on general sale, at 
least one! However, what I'm intending to do with 
it when | do get one is a complete unknown at 
the moment. | don't care, | just want to play, and 
learn - just like the old days again. 


Currently there are quite a few videos on the 
web site showing various features of the Pi. The 
{080P full HD can be seen in action as well as 
various other useful demos of various applica 
tions (Quake) having been ported or simply just 
running on a bare bones Pi connected to a TV. 
It's impressive. 

Equally impressive is just how popular this pro- 
ject has become. The web site is busy as are 
the forums and lots of people keep asking the 
age old questions “where do | buy one?’, 


Unlike Sinclair of old, no money will change hands 


until devices are physically available and ready. 
The Foundation doesn't want or need to get into 
a position of being accused of faking money to 
carry out beta work etc. They are up front: and 
extremely honest - they don’t want any money 
from you until you can actually buy something. 


They do have an online shop though - go to the 
main web page and click on the ‘shop’ link. It was 
set up to test out the purchasing processes and 
at present sells only a Raspberry Pi sticker for 
£110 including postage and packing. They sold 
out of the first batch extremely quickly and had 
to order more it - such was the interest. 


As with many things popular, once the idea takes 
off, the hangers on arrive. A web site in Russia 
was advertising Raspberry Pis for sale even 
when the Alpha boards hadn't been available - 
but that web site was soon shut down. There are 
no other web sites able to sell the Pi, so don't be 
tempted elsewhere. 


Unless, of course, you wish to be in at the very 
beginning. Ebay is selling the first 10 boards pro- 
duced, Each is numbered and they are proving 
extremely popular Board number 1 is currently 
being bid for at the cost of £3,300 - yes, that’s 
not a misprint, £3,300 for a £22 computer! 


Others in the series range from £780 to over 
£1,000 each! All proceeds from these 10 boards 
will go to the charity to help supply Raspberry 
Pis for schools, Stunning. 


When the boards go on general sale though, you 
won't have to pay nearly as much - £16 or £22 
should cover the bare board - youll need a 
keyboard, mouse and a TV or similar and. I'd 
advise adding a USB hub to multiply the ability to 
connect things. 


The Gertboard 


As | said above, Tinkerers rejoice! One of the 
developers - Gert van Loo - has designed the 
Gertboard to allow your Raspberry Pi fo be 
interfaced with the world at large. See the links 
below for the place to go for an introduction to 
what looks to be a stunning add on for the Pi. 


At the moment it appears that this board will be 
available only as a bare board and a list of parts 
you need to buy, however, there is talk of maybe 
perhaps a full or part kit being available some 
time. 


The board has lots of flashing LEDs, motor con- 
troller an PIC for Analogue to Digital conversions 
and so on and on and on! | want one! 


Useful Links 


The following is a list of useful links regarding the 
Raspberry Pi, 


http://www.raspberrypi.org/ - the main website. 
You can also join the mailing list here - but be 
aware that only ‘big’ announcements use the 
mailing list, that way, you don't feel as if you are 
being spammed. Check the main website for all 
the latest news. 


http://www.raspberrypi.org/forum - the forum. Lots 
of discussions, questions and answers here. Join 
up and join in. (ry not to get banned though!) 


http://elinux.org/RaspberryPiBoard - the wiki. Here 
you'll find full specs etc and lots of useful 
information. 


htip://elinux.org/RaspberryPiBoard#News_articles 
_and_blog_posts_about_Raspberry_Pi - a Wiki 
page with numerous links to articles etc about 
the Raspberry Pi. 


http://www.raspberrypl.org/archives/411 - Gert van 
Loo's add on ‘gertboard’ for the Raspberry Pi. 
http://www. raspberrypi.org/forum/educational- 


applications/gertboard - more details of the 
gertboard. 


Thanks to your continuing support, we 
are now looking towards volume 17. The 
aim of 32 pages per issue is more than 
fulfilled, and the DVD has been a great 
success too. 

The early renewals have been a great 
help and cost reduction, which allowed 
us to add many more pages than 
planned to the individual issues. 

We would like to continue with this 
process and ask you to renew as early as 
possible. We take the risk and keep the 
subscription rate at the same price as for 
the current issue (although printing 
costs have gone up as of last issue). 
There is also the risk of the postage 
being raised during the volume, but | 


hope it won't happen or - at least - be 
only 2 or 3%. Let's all be positive about 
it, it will work out somehow, | hope. 

We are even thinking about adding 
another extra goodie to one of the 


forthcoming issues. One possibility 
would be a CD, containing all the issues 
of volume 16 and other stuff. Rainer has 
already offered to scan the volumes. 

But we are also thinking about other 
things ... if you come up with an idea, 
please write to us and see if we can turn 
it into reality. Please remember, budget 
is tight and weight means high shipping 
costs. 

Please renew by using one of the many 
methods - as early as possible! 


We plan to have the next issue ready for you at the Vienna meeting - which is ealier | 
| than the standard schedule of the 4th issue of a Volume. As always, it depends on | 
| how quickly we get reviews, articles etc. So please send it as early as possible! 
,; We need more material, as always. The more we get and the sooner we get it, the | 
| quicker the next issue will be in your hands, and the better it will be. Hope to meet 
, you at one of the forthcoming QL shows - your QL Today Team! 


Quanta's 2012 Workshop and AGM will be held 
on 24-25th March 2012 at the 3rd Davyhulme 
Scout Headquarters, "The Endeavour’, Conway 
Road (off Lostock Road), Davyhulme, Manchester 
M41 OTF The venue is very easy to find - come 
off the M60 motorway at Junction 9 and take 
the West exit, signposted 'B5158 Urmston and 
Davyhulme’. Take the second right turning off 
this road (Lostock Road} onto Conway Road. 
The venue is down this lane on the right, near 
the first corner of the lane. If you need a map, 
use one of the mapping services on the Internet 
(e.g. Google maps or Streetmaps) to look for 
postcode M41 OTF 

All are welcome to this meeting, members and 
non-members alike. Whether you are a QL 
enthusiast or just curious about Sinclair's little 
multi-tasking black box. Admission is free. Tables 
will be available for those who would like to 
bring along their computer. 


The meeting at Prottes (near Vienna) is 
fixed, according to organizer Gerhard 
Plavec, 


The time to reserve in your agenda is the 
7th to 10th of June 2012. It is a ‘long’ 
weekend, like it was last year: Thursday ts 
a bank-holiday (at least in Germany and 
Austria}, so it should make the visit easier. 


The schedule for the days is similar to 
2010, but other sightseeing highlights are 
planned. The estimated schedule printed 
in the previous issue has slightly changed. 
{The planned visit of the tramway mu- 
seum moved to Sunday). 


The Saturday workshop opens at {{AM on the 
Saturday (doors open at 10AM for seiting up). 
On Sunday, the meeting opens at {0AM and 
the Annual General Meeting will be held at 2PM. 
Meet the experts! Come along and ask ques- 
tions and discuss your systems with traders 
and committee members. So far we expect 
RWAP Software and Memory Lane Computing 
to be there, so if you'd like to see the Ser-Usb 
device for the QL, or discuss Peter Graf's MDV 
slot SD card system, come along and meet 
Adrian Ives of Memory Lane Computing, for 
example. George Gwilt also hopes to be pre- 
sent to give a talk. 

For those coming from a little further afield, 
please contact Quanta Secretary or Chairman 
for help with finding place to stay in the area or 
for public transport details. For those coming 
from far enough to fly in, Manchester airport is 
just a short distance away. 

Homepage: www.quanta.org.uk 


Gerhard has updated the website, so 
please visit www.kuel.org for details! 


J-M-S plans to be at the meeting on at 
least two days, like last year. As Saturday 
will be the main day (with barbecue etc.), 
this will most likely be one of the days (if 
weather permits, of course). If you want me 
to bring anything you'd like to purchase 
(like QL Today back-issues), then please 
contact me (Jochen) a week in advance so 
that | can prepare it for you! 


Hope to see many of you there - looking 
forward to another great meeting! 


